home *** CD-ROM | disk | FTP | other *** search
/ The Latest & Greatest Top 201 Games / The Latest and Greatest Top 201 Games (Maple Media)(1994).iso / vgasolit / klondike.doc < prev    next >
Text File  |  1989-06-30  |  21KB  |  460 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                    KLONDIKE 
  18.                            
  19.                   Version 2.2
  20.  
  21.  
  22.  
  23.                Copyright 1989 by Eduardo Martins
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                 _______
  43.                            ____|__     |               (tm)
  44.                         --|       |    |-------------------
  45.                           |   ____|__  |  Association of
  46.                           |  |       |_|  Shareware
  47.                           |__|   o   |    Professionals
  48.                         -----|   |   |---------------------
  49.                              |___|___|    MEMBER
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.       INTRODUCTION
  57.       ============
  58.  
  59.       Klondike, also known under a variety of local names such as
  60.       Fascination and China-Man, is probably the best known solitaire card
  61.       game (actually, many people are not aware of the fact that Klondike
  62.       is just one of dozens of solitaire games, and use the name
  63.       'Solitaire' to refer to it). There are several shareware versions of
  64.       Klondike available for MS-DOS machines, but most of them have very
  65.       crude graphics (when they do have graphics at all!) and cumbersome
  66.       user interfaces. This prompted me to write a version that would take
  67.       full advantage of high-resolution EGA graphics. Several months and a
  68.       few thousand lines of Turbo Pascal 4.0 source code later, Klondike
  69.       1.0 was released. User response was very enthusiastic (although,
  70.       unfortunately, this did not translate into a significant number of
  71.       registrations...), and several users made suggestions that were
  72.       incorporated in version 2.0. The graphics were greatly enhanced, 
  73.       and compare favorably with commercial card games; new rules were
  74.       added, making the game more flexible and easier to win; and full 
  75.       mouse support was added, making the user interface very fluid and 
  76.       intuitive. This version (2.2) includes a few bug fixes, a configu-     
  77.       ration command that saves customized settings such as rules, card back, 
  78.       and mouse usage, and a slightly improved user interface. I hope
  79.       you'll enjoy Klondike 2.2, and encourage the development of 
  80.       high-quality shareware programs by filling out and sending the 
  81.       enclosed registration form.
  82.  
  83.  
  84.       SYSTEM REQUIREMENTS
  85.       ===================
  86.  
  87.       Klondike 2.2 runs on an IBM-PC or compatible running under MS-DOS
  88.       2.0 or greater, with an EGA/VGA monitor and display adapter (it
  89.       should run on an 8514 display adapter, but this was not tested).
  90.       256K of available memory are required. A Microsoft-compatible mouse
  91.       is strongly recommended, but the game can be played from the
  92.       keyboard. If you want to use the mouse, the mouse driver must be
  93.       installed before you load Klondike; please refer to your mouse
  94.       documentation for instructions. If you are running Klondike from a
  95.       hard disk, make sure that klondike.exe and the *.scr files are on
  96.       the current directory.
  97.  
  98.       A note on compatibility: Unfortunately, not all mouse drivers and
  99.       VGA systems were created equal. Klondike 2.2 runs without problems
  100.       using the Microsoft mouse driver version 6.00 or greater; if you are
  101.       using an older version you should get an upgrade, or use the -nomouse
  102.       option and play using the keyboard. A few users with VGA systems
  103.       reported some problems, but so far I haven't been able to duplicate
  104.       them. Klondike 2.2 was tested on an IBM PS/2 with the 8513 VGA 
  105.       monitor, and no problems were found. Finally, Klondike 2.2 is NOT
  106.       DesqView aware. Later versions should have this feature, but, for
  107.       now, avoid running Klondike on a DesqView window.
  108.  
  109.  
  110.       KLONDIKE RULES
  111.       ==============
  112.  
  113.       One regular pack of 52 cards is used. Deal 28 cards into 7 piles. The
  114.       first pile at the left has one card, the second two, and so on, up to
  115.       seven in the last pile. The top card of each pile is face up; all the
  116.       rest are face down. On the piles you may build in descending
  117.       sequence, red on black or black on red. For example, on the 8 of
  118.       spades you can place either the 7 of hearts or the 7 of diamonds. All
  119.       the face up cards on a pile may be moved as a unit, and matched
  120.       according to the bottom card. When you uncover a face down card on a
  121.       pile, turn it face up. If one pile is entirely removed, you may put a
  122.       king in the space. Each time you free an ace, move it to the
  123.       Foundation, a row above the piles. On the Foundation you build up in
  124.       suit and sequence. For example, the 2 of hearts may be placed on the
  125.       Ace of hearts, the 3 of hearts may be placed over the 2 of hearts, and
  126.       so on. To win the game, you have to build each Foundation up to the
  127.       king. Once placed on the Foundation, a card cannot be moved anywhere
  128.       else. From the rest of the pack, turn up cards one by one. Put cards
  129.       that you cannot use into a waste pile. You can always use the top
  130.       card of the waste pile. You may go through the pack only once. The
  131.       game ends either when you win by building each Foundation up to the
  132.       king, or when your moves reach a standstill.
  133.  
  134.  
  135.       Alternate Rules
  136.  
  137.       Klondike, as played by its original rules, is very hard to win (it
  138.       has been estimated that the chances of winning are one in every
  139.       thirty games!) and thus can be a bit frustrating.  Two popular
  140.       variations greatly increase the odds of winning. Under the first
  141.       variation, cards are moved from the Pack to the Waste Pile in groups
  142.       of three, and you can go through the Pack as many times as you wish,
  143.       i.e., once the Pack is exhausted, you move all the cards from the
  144.       Waste Pile back to the Pack. Under the second variation, cards are
  145.       turned up from the Pack one by one, as in the original rules, but you
  146.       can go through the Pack an unlimited number of times, as in the first
  147.       variation. This is the easiest of all three playing modes.
  148.  
  149.       You can also use the 'relaxed movement' rule. Under the original
  150.       Klondike rules, you must move all face-up cards on a pile as a
  151.       unit (with the exception that, when you are moving from the pile to
  152.       the Foundation, you move the top card of the pile alone). Under the
  153.       'relaxed movement' rule, you can move all face-up cards as a unit;
  154.       the top card alone, or any contiguous block of cards beginning at
  155.       the top card. Suppose you have a pile with a 4-5-6-7-8 face-up. If
  156.       you're using the 'relaxed movement' rule, you can move all five
  157.       cards as a unit, or the 4-5-6-7 block, or the 4-5-6, or 4-5, or the 4
  158.       alone. Through skillful manipulation of the cards, you can free
  159.       cards that would otherwise be unavailable, and win games that would
  160.       be unwinnable under the regular rules. This makes the game more
  161.       challenging, because it gives you a greater chance of winning against
  162.       a bad deal.
  163.  
  164.  
  165.  
  166.       COMMANDS
  167.       ========
  168.  
  169.       Mouse:
  170.  
  171.       To move a card, first place the mouse cursor over the card (or pile)
  172.       you want to move and press the left mouse button, then place the
  173.       cursor over where you want to put the card (or pile) and press the
  174.       left button again. Notice that the cursor changes to a pointing hand
  175.       whenever it is over a card or pile that can be moved. After you
  176.       select the card (or pile) to move by pressing the left mouse button,
  177.       the cursor changes to an hourglass to indicate that it is waiting
  178.       for you to enter the destination of the move. Whenever you place it
  179.       over a location that could be used as a destination, it will change
  180.       from the hourglass back to a pointing hand (note that this does not
  181.       check for a valid move. It merely tells you that you could move a
  182.       card from pile 1 to pile 5, if the cards match, but that you could
  183.       never move a card from pile 1 to the waste pile). If you select a
  184.       card to be moved and decide not to move that card, press both mouse
  185.       buttons simultaneously to cancel the move command. To move a card
  186.       from the Deck to the Waste Pile, press the right mouse button.
  187.  
  188.       If a card is face down, just place the mouse cursor over it and
  189.       press the left mouse button to turn the card face up.
  190.  
  191.       To change the rules, click the Rules button. Under rules 2 and 3
  192.       the Waste pile can be re-used. When the Pack is exhausted, click the
  193.       right mouse  button and the Waste Pile will be moved back to the Pack.
  194.  
  195.       Click the Finish button to have the computer move all cards that can
  196.       be moved from the Tableau to the Foundation automatically.
  197.  
  198.       Click the Quit button to quit Klondike, Back to change the card
  199.       design, Help to display a Help screen, and Info to display version
  200.       and Copyright information.
  201.  
  202.  
  203.       Keyboard:
  204.  
  205.       To Move a card, first press the key corresponding to the Origin, then
  206.       press the key corresponding to the Destination. For example, to move
  207.       from the Pack to pile 1, press 'P' then '1'. Valid Origins are 1 to
  208.       7, P, and W. Valid Destinations are 1 to 7, W, and F. If you select
  209.       a card to be moved and decide not to move that card, press the 'Esc'
  210.       key to cancel the move command. If a card is face down, press the key
  211.       corresponding to that card and it will be turned face up. You can
  212.       turn only the first card of the Pack and cards on the Tableau (1 to
  213.       7) that are face down.
  214.  
  215.       To change the rules, press 'R'. Under rules 2 and 3, the Waste pile
  216.       can be re-used. When the Pack is exhausted, press 'P' and the Waste
  217.       pile will be moved back to the Pack.
  218.  
  219.       Press 'F' to have the computer move all cards that can be moved from
  220.       the Tableau to the Foundation automatically.
  221.  
  222.       Press 'Q' to quit Klondike, 'B' to change the card design, and 'I'
  223.       to display version and Copyright information.
  224.  
  225.  
  226.       COMMAND-LINE OPTIONS
  227.       ====================
  228.  
  229.       The following options can be specified when you load Klondike:
  230.  
  231.       -mouse:   selects the mouse as the input device, and bypasses the 'Do
  232.                 you want to use the mouse?' menu. This option is ignored
  233.                 if a mouse driver is not found
  234.       -nomouse: selects the keyboard as the input device, and bypasses the
  235.                 'Do you want to use the mouse?' menu
  236.       -inst:    display instructions at the beginning of the game, bypassing
  237.                 the 'Do you want instructions?' menu
  238.       -noinst:  do not display instructions at the beginning of the game,
  239.                 bypassing the 'Do you want instructions?' menu
  240.       -nosound: turns sound off (Default is sound on)
  241.       -nomenu:  suppresses the on-screen menu (this option is ignored when
  242.                 you are using the mouse; default is menu on)
  243.       -back[n]: selects card back [n], where [n] is a number from 1 to 5
  244.                 (Default is -back1)
  245.       -rule[n]: selects rule set [n], where [n] is a number from 1 to 3
  246.                 (Default is -rule1)
  247.       -relaxed: selects 'relaxed movement' rule (Default is Strict)
  248.  
  249.  
  250.       CONFIGURATION
  251.       =============
  252.  
  253.       A new command, 'Config', allows you to save your customized config-
  254.       uration. Click the Config button (or press "C" if using the keyboard)
  255.       and a dialog box will appear. Select whether or not you want to use
  256.       the mouse by choosing 'Yes', 'No', or 'Ask'. If you select 'Ask', a
  257.       dialog box will pop-up every time you run Klondike and ask if you
  258.       want to use the mouse (assuming you have a mouse driver loaded). If
  259.       you select 'Yes' but a mouse driver is not found, the game will go
  260.       to keyboard mode. Then, select whether or not you want instructions
  261.       displayed when you run Klondike. Choosing 'Yes' will display the
  262.       instructions screens every time you load the program, 'No' will skip
  263.       the instructions screens, and 'Ask' will pop-up a dialog box asking
  264.       if you want instructions displayed. Finally, select Sound on or off.
  265.  
  266.       If you want to configure Klondike to use a rule set other than the
  267.       default (Rule set 1), or a particular card design, choose the rule
  268.       set and the card design (by using the 'Rules' and 'Back' commands)
  269.       BEFORE you use the 'Config' command. When Config saves your config-
  270.       uration, it will save the currently selected rule set and card design.
  271.  
  272.       Note that the mouse, instructions and sound options only become 
  273.       effective the next time you load Klondike. Since the configuration 
  274.       information is written on the EXE file itself, do not put a write 
  275.       protect tab on the disk if you're using a floppy, or set the
  276.       Klondike.exe read-only attribute. Finally, note that the command
  277.       line switches take precedence over the saved configuration. So, if
  278.       you have Klondike configured to use the mouse, and you want to play
  279.       using the keyboard, you can load it by typing the command
  280.       'klondike -nomouse' and the mouse option will be overridden.
  281.  
  282.  
  283.       NOTES FOR USERS OF PREVIOUS VERSIONS
  284.       ====================================
  285.  
  286.       A few small but significant changes were made in the user interface,
  287.       making it more intuitive and easier to use. 
  288.       
  289.       * When using the mouse, you no longer have to press the right button to
  290.         finish moving a card. Simply press the left button again and the move
  291.         will be made. Press the right button to move a card from the Pack to
  292.         the Waste Pile. You can still place the cursor over the Pack, click
  293.         the left button, then place the cursor over the Waste Pile, and click
  294.         the left button again, but it is obviously a lot easier just to click
  295.         the right button (the cursor doesn't even have to be over the Pack).
  296.       
  297.       * The 'Re-Use' command is gone. After the Pack is exhausted, simply
  298.         press the right mouse button (as if you were moving one more card from
  299.         the Pack to the Waste) and the Waste will be moved back to the
  300.         Pack (assuming, of course, that you are using either rule set 2 or 3).
  301.         If you're playing from the keyboard, press "P" (for Pack) instead. 
  302.         
  303.       * The Tutorial is gone. Klondike is getting bigger with every new
  304.         release, and I suspect that very few (if any) people ever used
  305.         the Tutorial, so it was deleted to save space. 
  306.       
  307.       A new Registration procedure has been added. After you register,
  308.       you will receive a registration number and instructions on how to
  309.       'burn it' into your Klondike copy. This number will then be displayed
  310.       when you issue the 'Info' command, and the Shareware screen that is
  311.       displayed on unregistered copies will be suppressed. Note that these
  312.       are the ONLY differences between registered and unregistered copies;
  313.       the 'evaluation copy' is fully functional, and is not crippled in
  314.       ANY way. If you are a registered user of version 2.1 or earlier,
  315.       send me a note and I'll send you your registration number.
  316.       
  317.       ACKNOWLEDGEMENTS
  318.       ================
  319.  
  320.       Klondike was written using Turbo Pascal 4.0 (and later converted to
  321.       TP 5.0). I wish to thank Borland International for their outstanding
  322.       compiler. Special thanks go to everybody at CompuServe's Borland Forum 
  323.       (especially Brian Foley). Their help and support has been invaluable. 
  324.       I'd also like to thank the following individuals:
  325.  
  326.       - Neil Rubenking, author of PianoMan, used to add the title and
  327.         congratulation screen songs;
  328.  
  329.       - Michael Day, author of the Mouse unit, used to add mouse support;
  330.  
  331.       - Scott Bussinger, author of the Backplay unit, used to play the
  332.         congratulation screen song on the background;
  333.  
  334.       - Tim Godfrey, author of the GrafText unit, used for the extremely
  335.         fast graphics-mode screen writes;
  336.  
  337.       - [unknown] author of the DrawPics unit, used to display the
  338.         high-resolution card images; and
  339.  
  340.       - Mael Martins, John Middleton, and David Blair, who made invaluable 
  341.         suggestions and beta-tested the program.
  342.  
  343.  
  344.       ABOUT SHAREWARE
  345.       ===============
  346.  
  347.       (Definition supplied by the Association of Shareware Professionals)
  348.  
  349.       Shareware distribution gives users a chance to try software before
  350.       buying it.  If you try a Shareware program and continue using it, you
  351.       are expected to register.  Individual programs differ on details --
  352.       some request registration while others require it, some specify a
  353.       maximum trial period.  With registration, you get anything from the
  354.       simple right to continue using the software to an updated program
  355.       with a printed manual.
  356.  
  357.       Copyright laws apply to both Shareware and commercial software, and
  358.       the copyright holder retains all rights, with a few specific
  359.       exceptions as stated below.  Shareware authors are accomplished
  360.       programmers, just like commercial authors, and the programs are of
  361.       comparable quality. (In both cases, there are good programs and bad
  362.       ones!)  The main difference is in the method of distribution. The
  363.       author specifically grants the right to copy and distribute the
  364.       software, either to all and sundry or to a specific group. For
  365.       example, some authors require written permission before a commercial
  366.       disk vendor may copy their Shareware.
  367.  
  368.       So, Shareware is a distribution method, not a type of software. You
  369.       should find software that suits your needs and pocketbook, whether
  370.       it's commercial or Shareware.  The Shareware system makes fitting your
  371.       needs easier, because you can try before you buy. And because the
  372.       overhead is low, prices are low also. Shareware has the ultimate money-
  373.       back guarantee -- if you don't use the product, you don't pay for it.
  374.  
  375.       This program is produced by a member of the Association of Shareware
  376.       Professionals (ASP).  ASP wants to make sure that the shareware
  377.       principle works for you. If you are unable to resolve a shareware-
  378.       related problem with an ASP member by contacting the member directly,
  379.       ASP may be able to help. The ASP Ombudsman can help you resolve a
  380.       dispute or problem with an ASP member, but does not provide technical
  381.       support for members' products. Please write to the ASP Ombudsman at
  382.       P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message via
  383.       easyplex to ASP Ombudsman 70007,3536.
  384.  
  385.       You are granted a license to try this program for a period of 21
  386.       days. If you continue to use this program after the trial period is
  387.       over, you must register by sending the registration form and $15 to
  388.  
  389.                             Eduardo Martins
  390.                             Station A  P.O. Box 2052
  391.                             Champaign, IL  61825-2052
  392.  
  393.       If you have any comments or suggestions, please write to the above
  394.       address, or leave electronic mail on CompuServe to Eduardo Martins
  395.       [73300,267] or on GEnie to e.martins.
  396.  
  397.       This program may not be sold in any form without the express written
  398.       consent from the author. If you distribute Klondike to friends or to
  399.       Bulletin Board systems, PLEASE distribute it under the name 
  400.       KLONDK22.EXE, and use the unmodified, self-extracting LHARC archive
  401.       as the distribution copy.
  402.  
  403.  
  404.  
  405.       REGISTRATION FORM                                    KLONDK22      
  406.       =================
  407.  
  408.  
  409.  
  410.       To register Klondike, please send this form and a $15 check to
  411.  
  412.              Eduardo Martins
  413.              Station A  P.O. Box 2052
  414.              Champaign, IL  61825-2052
  415.  
  416.       NAME: _________________________________________________
  417.  
  418.       ADDRESS: ______________________________________________
  419.  
  420.                ______________________________________________
  421.  
  422.                ______________________________________________
  423.  
  424.  
  425.        Where did you get your copy of Klondike?
  426.        _
  427.       |_| CompuServe                     CIS User ID: ___________________
  428.        _
  429.       |_| GEnie                     GEnie address: _________________
  430.        _
  431.       |_| BBS (please give name and number): _____________________________
  432.        _
  433.       |_| Public (software) Library
  434.        _
  435.       |_| Other (please specify): ________________________________________
  436.  
  437.  
  438.  
  439.       Comments/Suggestions
  440.  
  441.       ____________________________________________________________________
  442.  
  443.       ____________________________________________________________________
  444.  
  445.       ____________________________________________________________________
  446.  
  447.       ____________________________________________________________________
  448.  
  449.       ____________________________________________________________________
  450.  
  451.       ____________________________________________________________________
  452.  
  453.  
  454.  
  455.  
  456.  
  457.       Thank you for registering Klondike!
  458.  
  459.  
  460.